home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm1 / dransi12.zip / DRANSI.DOC < prev    next >
Text File  |  1993-05-01  |  33KB  |  885 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.            ▓▓▓▓▓┐   ▓▓▓▓▓┐          ▓▓▓▓┐   ▓▓┐ ▓▓┐   ▓▓▓▓┐  ▓▓▓▓▓▓┐
  8.            ▓▓┌─▓▓┐  ▓▓┌─▓▓┐        ▓▓┌─▓▓┐  ▓▓▓┐▓▓│  ▓▓┌──┘   └▓▓┌─┘
  9.            ▓▓│ ▓▓│  ▓▓│ ▓▓│        ▓▓│ ▓▓│  ▓▓┌▓▓▓│   ▓▓▓┐     ▓▓│
  10.            ▓▓│ ▓▓│  ▓▓▓▓▓┌┘        ▓▓▓▓▓▓│  ▓▓│ ▓▓│    └▓▓┐    ▓▓│
  11.            ▓▓▓▓▓┌┘  ▓▓┌─▓▓┐        ▓▓┌─▓▓│  ▓▓│ ▓▓│  ▓▓▓▓┌┘  ▓▓▓▓▓▓┐
  12.             └───┘    └┘  └┘         └┘  └┘   └┘  └┘   └──┘    └────┘
  13.  
  14.  
  15.                                      v1.2
  16.                                     
  17.                           An ANSI screen viewing door
  18.                                 
  19.                               (C) Copyright 1993
  20.  
  21.  
  22.  
  23.  
  24. ╓────────────────────────────────────────────────────────────────────────────╖
  25. ║ ░░░░░░░ DR ANSI v1.2 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  26. ╙────────────────────────────────────────────────────────────────────────────╜
  27.  
  28.                     Documentation and programming by Dan Roseen
  29.  
  30.  
  31. ╓────────────────────────────────────────────────────────────────────────────╖
  32. ║ ░░░░░░░ TABLE OF CONTENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  33. ╙────────────────────────────────────────────────────────────────────────────╜
  34.  
  35.  INTRODUCTION
  36.  
  37.    1.1  Introduction . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  38.    1.2  Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  39.    1.3  Files  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  40.    1.4  Options and Features . . . . . . . . . . . . . . . . . . . . . .   3
  41.  
  42.  DR ANSI SETUP & OPERATION
  43.  
  44.    2.1  Setup  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  45.    2.2  Configuration File . . . . . . . . . . . . . . . . . . . . . . .   7
  46.    2.3  ANSI Category Screen . . . . . . . . . . . . . . . . . . . . . .   9
  47.    2.4  Help Screen  . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  48.    2.5  Viewing ANSI Screens . . . . . . . . . . . . . . . . . . . . . .  11
  49.    2.6  Baud Rate/ANSI Size Filter . . . . . . . . . . . . . . . . . . .  11
  50.    2.7  Download Option  . . . . . . . . . . . . . . . . . . . . . . . .  12
  51.    2.8  Errorlevels  . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  52.  
  53.  CLOSING
  54.  
  55.    3.1  Registration . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  56.    3.2  Support and Distribution . . . . . . . . . . . . . . . . . . . .  14
  57.    3.3  Thank You To:  . . . . . . . . . . . . . . . . . . . . . . . . .  15
  58.    3.4  Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . .  15
  59.  
  60.                                      Page 1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. ╓────────────────────────────────────────────────────────────────────────────╖
  73. ║  1.1    INTRODUCTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  74. ╙────────────────────────────────────────────────────────────────────────────╜
  75.  
  76.  DR ANSI was developed for several reasons:
  77.    
  78.  ■  I wanted to replace the ANSI door currently on my system since it
  79.     was missing some features that are important for my BBS.
  80.  ■  I discovered OpenDoors, a 'C' door writing library that is fantastic!
  81.  
  82.  DR ANSI was written using Borland's C++ v3.1 and OpenDoors v4.1.  It
  83.  requires an IBM PC, AT, or 100% compatible computer.  This version has been
  84.  tested with RemoteAccess v1.11 & v2.00Γ, Wildcat! 3.6M, under MS-DOS v5.0,
  85.  and DESQview v2.42, and QEMM v6.02.  DR ANSI was tested remotely with Telix
  86.  and Qmodem communications software.  DR ANSI requires a fossil driver, and
  87.  has been tested with BNU v1.70 and X00 v1.24.
  88.  
  89.  
  90. ╓────────────────────────────────────────────────────────────────────────────╖
  91. ║  1.2    DISCLAIMER   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  92. ╙────────────────────────────────────────────────────────────────────────────╜
  93.  
  94.  DR ANSI is provided AS IS.  I give no warranty of any kind, nor am I
  95.  responsible for the results of use or misuse of the program.
  96.  
  97.  
  98.  
  99. ╓────────────────────────────────────────────────────────────────────────────╖
  100. ║  1.3    FILES        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  101. ╙────────────────────────────────────────────────────────────────────────────╜
  102.  
  103.  DRANSI.CFG  . . . . . . . . . Sample of a DR ANSI configuration file
  104.  DRANSI.DOC  . . . . . . . . . This documentation text file
  105.  DRANSI.EXE  . . . . . . . . . DR ANSI program
  106.  DRANSI.HIS  . . . . . . . . . DR ANSI history of changes
  107.  DRANSI.HLP  . . . . . . . . . DR ANSI help file
  108.  DRANSI.REG  . . . . . . . . . DR ANSI registration form
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                      Page 2
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. ╓────────────────────────────────────────────────────────────────────────────╖
  132. ║  1.4    OPTIONS AND FEATURES ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  133. ╙────────────────────────────────────────────────────────────────────────────╜
  134.  
  135.    ■ Fully functional shareware.
  136.  
  137.    ■ Vertically sorted ANSIs.
  138.    
  139.      The list of ANSI screens will automatically format itself to give
  140.      a pleasing appearance with different amounts of ANSI screens.  For
  141.      example:  100 ANSI screens will be 5 columns of 20 length, while
  142.      a much lower number of ANSI screens may be 4 (or even 3) columns
  143.      of lesser length.
  144.      
  145.    ■ 4,000 ANSI screen maximum (40 categories X 100 screens/category).
  146.      Each selection screen can contain up to 100 ANSI screens.  The
  147.      documentation describes how you can make use of more than 100 ANSI
  148.      screens per selection screen, but user selection is still limited
  149.      to 100 per screen.
  150.  
  151.    ■ Simultaneous multi-node use does not require a batch file.
  152.  
  153.    ■ 'Slide-show' of ANSI screens because of multiple selection
  154.      capability.  The user has the ability to select and add individual
  155.      screens as well as ranges of screens to a slide-show.
  156.  
  157.    ■ "Baud rate/ANSI size" filter.  The sysop can set the maximum ANSI
  158.      file size for specified baud rates.  This is an optional feature
  159.      that will permit the sysop to have DR ANSI not even list big ANSIs
  160.      (such as long-playing animations) for callers at low speeds.  This
  161.      will help prevent users from feeling like they have to drop-
  162.      carrier in order to get out of viewing an ANSI that takes a long,
  163.      long time for their baud rate.  It will also prevent users from
  164.      greatly exceeding their time left on the BBS.
  165.  
  166.    ■ Built-in ANSI emulator lets you use DR ANSI locally without even
  167.      using DOS's ANSI.SYS or DESQview's DVANSI.COM.
  168.  
  169.    ■ "Already seen" filter.  The user's previously selected keys will
  170.      almost dissappear from the selections available.  However, the
  171.      user will be able to view the same ANSI again if they desire.
  172.  
  173.  
  174.  
  175.  
  176.                                      Page 3
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183. ╓────────────────────────────────────────────────────────────────────────────╖
  184. ║  1.4    OPTIONS AND FEATURES (continued) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  185. ╙────────────────────────────────────────────────────────────────────────────╜
  186.  
  187.    ■ Download capability.
  188.        ■ Optional configuration variables for DSZ/GSZ and download
  189.          capability.  If download capability is turned on, and the DSZ
  190.          config. variable is not defined, then DR ANSI will search the
  191.          BBS system's path to find DSZ/GSZ.
  192.        ■ DSZ/GSZ support.
  193.            ■ DSZ.COM, DSZ.EXE, or GSZ.EXE.
  194.            ■ Xmodem, Ymodem, and Zmodem support.
  195.            ■ DR ANSI uses return errorlevels to distinguish between
  196.              successful and unsuccessful transfers.
  197.        ■ "Already-downloaded" filter shows user what ANSIs have already
  198.          been downloaded.
  199.        ■ Complete file info given (file size, estimated transfer time,
  200.          etc.)
  201.  
  202.    ■ Attention to details to keep it looking clean and easy to use (e.g.
  203.      extra attention given to sysop break for chat and shell to DOS.  User
  204.      also has capability to 'S'top/Skip or 'P'ause ANSI viewing, help, or
  205.      selection screen).
  206.  
  207.    ■ Error levels upon door exit for those who wish to monitor things like
  208.      drop-carriers, keyboard inactivity timeout, etc.
  209.  
  210.    ■ DESQview-aware.  It will use BIOS screen writes and share CPU time
  211.      slices with other processes when in DESQview.
  212.  
  213.    ■ Sysop shell to DOS uses EMS memory if available.
  214.  
  215.    ■ Online help.  Can be customized by sysop.
  216.  
  217.    ■ No maintenance (just dump more ANSI screens into the directory).
  218.    
  219.    ■ Supports up to 38.4K baud.
  220.  
  221.    ■ Automatic support for many BBS types.  Supports user drop files
  222.      as listed:
  223.                    DORINFO?.DEF            CALLINFO.BBS
  224.                  * EXITINFO.BBS (Normal)   DOOR.SYS (GAP/PC-Board)
  225.                    CHAIN.TXT               DOOR.SYS (Doorway style)
  226.                    SFDOORS.DAT             DOOR.SYS (WildCat standard)
  227.  
  228.                  * Support for RA and QuickBBS's extended EXITINFO.BBS
  229.                    formats has been disabled so that this program can be
  230.                    used as intended with other drop files supported by RA
  231.                    and QuickBBS.  This will prevent this program from
  232.                    possible damage of user records if the BBS authors
  233.                    change their extended EXITINFO.BBS files in the future.
  234.  
  235.                                      Page 4
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247. ╓────────────────────────────────────────────────────────────────────────────╖
  248. ║  2.1    SETUP        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  249. ╙────────────────────────────────────────────────────────────────────────────╜
  250.  
  251.  By default, DR ANSI will allow display of *.ANS files in it's directory, so
  252.  you may want to make a directory just for DR ANSI.
  253.  
  254.  Also by default, DR ANSI will look in the current working directory for the
  255.  BBS's user drop file.  If DR ANSI is in a directory other than the user drop
  256.  files, you can specify the directory pathname to the user info files as an
  257.  argument to DRANSI.EXE as shown:
  258.  
  259. pathname_to_dransi_directoryDRANSI
  260.  
  261.   or
  262.  
  263. DRANSI door_drop_files_directory(user_info_files)
  264.  
  265.  Suggested setup for single or multi-node:
  266.  ─────────────────────────────────────────
  267.  
  268.    DR ANSI will find related files in the directory of the pathname of
  269.    DRANSI.EXE itself.  For example:  \RA\DOORS\DRANSI\DRANSI.EXE
  270.    will run DRANSI.EXE using the ANSI files and optional files of the
  271.    \RA\DOORS\DRANSI\ directory.  This makes it very easy to run
  272.    DR ANSI multi-node since it can be executed from the drop directory
  273.    and will read the user drop files in that directory.  Therefore
  274.    no batch file is ever needed for single or multi-node.  On my BBS
  275.    I simply have the command \RA\DOORS\DRANSI\DRANSI.EXE execute from
  276.    the BBS menu and it lets people use the door simultaneously from
  277.    any existing line or line that I add in the future with no batch file.
  278.  
  279.    Example:  C:\RA\DOORS\DRANSI\DRANSI.EXE
  280.  
  281.              (This is my setup.  I run it directly from the user's menu.
  282.               In my case, this is a RemoteAccess menu and the above example
  283.               is inserted in the optional data field of a Type 7 menu item.)
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                      Page 5
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306. ╓────────────────────────────────────────────────────────────────────────────╖
  307. ║  2.1    SETUP (continued) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  308. ╙────────────────────────────────────────────────────────────────────────────╜
  309.  
  310.  Alternative (considered normal) multi-node setup:
  311.  ─────────────────────────────────────────────────
  312.  
  313.    Suppose you have a multiple line RemoteAccess BBS that has directories
  314.    \RA\LINE1, \RA\LINE2, ...   You also have a directory for DR ANSI called
  315.    \RA\DOORS\DRANSI and a batch file in your \RA directory similiar to the
  316.    file shown below:
  317.  
  318. :: DRANSI.BAT - This batch file will use the DORINFO1.DEF file for each
  319. ::              particular BBS line.  It will move the user to the DR ANSI
  320. ::              directory, run the program, then move him back to the
  321. ::              Line directory that he came from before returning back to
  322. ::              the BBS.
  323. ::
  324. ::              DR ANSI's menu selection is a Type 7 with the following
  325. ::              optional data:  *C /C \RA\DRANSI.BAT *N
  326. ::
  327. ::              The "*N" argument to the batch file is the node number of
  328. ::              the BBS line and is used to locate the correct user info
  329. ::              files on a multi-node system because the batch file's
  330. ::              "%1" variable becomes the value of "*N".
  331.  
  332. CD \RA\DOORS\DRANSI
  333. DRANSI \RA\LINE%1
  334. CD \RA\LINE%1
  335.  
  336.  
  337.  Local (local without BBS user drop files):
  338.  ──────────────────────────────────────────
  339.  
  340.    You can run DR ANSI locally with any of the following formats:
  341.  
  342. DRANSI LOCAL
  343. DRANSI /LOCAL
  344. DRANSI -LOCAL
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.                                      Page 6
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363. ╓────────────────────────────────────────────────────────────────────────────╖
  364. ║  2.2    CONFIGURATION FILE ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  365. ╙────────────────────────────────────────────────────────────────────────────╜
  366.  
  367.  The remainder of this section is an actual configuration file (filled with
  368.  comments) for the configuration file:
  369.  
  370. ## DRANSI.CFG - Existence of this configuration file is optional.  However,
  371. ## to find out the benefits of having this file, please read on.
  372. ##
  373. ## The format of this file is simple.  Any line that doesn't start out with
  374. ## keywords are considered a comment.  Keywords can appear in any order in
  375. ## this configuration file.  They are as described:
  376. ##
  377. ## REG       - Add your registration number when you get it.
  378. ## SYSOP     - Add your sysop name after this keyword.
  379. ## EXT/CAT   - Add the file extention for each category, followed by
  380. ##             a '/' character, followed by a description of 30 characters
  381. ##             or less (longer descriptions are truncated).
  382. ## BAUD/SIZE - Add a baud rate, followed by a '/' character, followed by
  383. ##             the maximum size of ANSI that a caller at that baud rate
  384. ##             or lower can view.  The order of how the baud rate is listed
  385. ##             in this configuration file is not important.  Any baud rate
  386. ##             can be specified.  You can control 0 baud (local mode) by
  387. ##             including it in this file, otherwise 0 baud has no limit.
  388. ## DSZ       - DSZ/GSZ file_pathname (DR ANSI searches path by default if
  389. ##             file_pathname is not specified and DOWNLOAD ON is specified).
  390. ## DOWNLOAD  - Download option for users?  Specify DOWNLOAD ON or OFF
  391. ##             (default is OFF).
  392. ## PROMPT    - Visually prompt user to press Enter after viewing an ANSI?
  393. ##             Specify PROMPT ON or OFF (default is ON).
  394.  
  395. ## In order to show DR ANSI as registered software, this configuration file
  396. ## must exist in the same directory as DRANSI.EXE and the sysop name and
  397. ## correct registration number must be filled in.
  398.  
  399. REG   00000
  400. SYSOP Dan Roseen
  401.  
  402. ## The following "EXT/CAT" keyword example (commented so it won't be used
  403. ## by default when first setting up this door) will enable an ANSI category
  404. ## selection menu when DR ANSI is run.  Up to 40 categories can be created.
  405. ## DR ANSI will select the first 100 files with the filename extension
  406. ## specified for a particular category.  This example will cause DR ANSI to
  407. ## use the first 100 *.ANS files for the "General ANSI" category.  The
  408. ## Categories will be displayed in the order that they are read from this
  409. ## configuration file.  *.ANS files are used if no categories are defined.
  410.  
  411. #EXT/CAT ANS/General ANSI
  412.  
  413.  
  414.  
  415.                                      Page 7
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424. ╓────────────────────────────────────────────────────────────────────────────╖
  425. ║  2.2    CONFIGURATION FILE (continued) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  426. ╙────────────────────────────────────────────────────────────────────────────╜
  427.  
  428. ## The purpose of "BAUD/SIZE" configurations is to prevent low speed callers
  429. ## from selecting very large ANSI screens in DR ANSI.  ANSIs larger than
  430. ## permitted won't appear in a listing.  "BAUD/SIZE" settings are optional.
  431. ##
  432. ## With the settings shown below, viewing of ANSIs will be as follows:
  433. ##
  434. ##            CALLER (baud)  ANSI SIZE (bytes)
  435. ##            ─────────────  ─────────────────────────────────────────
  436. ##                  0        No Limit (no limit for 0 baud unless specified)
  437. ##                300         1500
  438. ##               1200         6000
  439. ##               2400        50000    (uses next highest since commented)
  440. ##               9600        No Limit (nothing was specified over 4800)
  441. ##
  442. ## Note:  You can set 0 baud's maximum file size to match another baud rate
  443. ##        to see the ANSI selections available for the other baud rate.
  444.  
  445. BAUD/SIZE  300/1500
  446. BAUD/SIZE 1200/6000
  447. #BAUD/SIZE 2400/35000
  448. BAUD/SIZE 4800/50000
  449.  
  450. ## An "[Enter]" prompt can be displayed to the user after an ANSI screen has
  451. ## been viewed.  This is turned on by default, but you can turn it off (the
  452. ## user is still prompted to press Enter or Space but is not asked visually).
  453. ## Use either "PROMPT OFF" or "PROMPT ON".
  454.  
  455. #PROMPT OFF
  456.  
  457. ## Do you want your users to be able to download your ANSI screens?  You can
  458. ## use "DOWNLOAD OFF" or "DOWNLOAD ON" (default is off).  You can also
  459. ## specify the file pathname of DSZ or GSZ (default is to search the path)
  460. ## with the DSZ configuration variable.  For example:  DSZ C:\DSZ\DSZ.COM
  461. ## Note: DR ANSI will only show download capability at baud rates greater
  462. ##       than 0.
  463.  
  464. DOWNLOAD OFF
  465. #DSZ C:\DSZ\DSZ.COM
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.                                      Page 8
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485. ╓────────────────────────────────────────────────────────────────────────────╖
  486. ║  2.3    ANSI CATEGORY SCREEN ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  487. ╙────────────────────────────────────────────────────────────────────────────╜
  488.  
  489.  DR ANSI will support up to 4,000 ANSI screens by using the ANSI Category
  490.  feature.  Up to 40 categories can be created.  DR ANSI will select the first
  491.  100 files with the filename extension specified for a particular category.
  492.  Use of ANSI Categories is optional.  Please see the "Configuration File"
  493.  section for information on using this feature.
  494.  
  495.  
  496. ╓────────────────────────────────────────────────────────────────────────────╖
  497. ║  2.4    HELP SCREEN  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  498. ╙────────────────────────────────────────────────────────────────────────────╜
  499.  
  500.  Help for DR ANSI is available as a selection in the category and ANSI
  501.  selection screens.  The help is in the form of a standard text file (not
  502.  ANSI) to ensure that DR ANSI will have full control of line count, screen
  503.  clear, screen redraw, and 'More?' prompting, in the event of a sysop chat,
  504.  shell to DOS, etc.
  505.  
  506.  Use of an ANSI screen for this purpose was rejected due to the likelihood
  507.  of many people saving their help file with ANSI drawing utilities in an ANSI
  508.  format that doesn't represent each displayed line as a separate line in the
  509.  help file.
  510.  
  511.  
  512.  I don't expect there will be many who feel a real need to colorize their
  513.  help file, but here's a way to do just that:
  514.  
  515.  Color code capability was added for those sysops who want to customize and
  516.  spice up their help text file with color.
  517.  
  518.  The color code is just placed in the text file with the format:
  519.      ~X  (where 'X' is the number of the color attribute + 40,
  520.           and the + 40 is added in to ensure that a single character can
  521.           easily be used to avoid things like the tab character, etc.)
  522.  
  523.  The color attribute is computed from the IBM-style screen attribute.
  524.  Hence, you can set the color of text to be displayed by a single
  525.  character that is derived from the hexidecimal value.
  526.  
  527.                  ┌───────────── Background color
  528.                  │
  529.                0x7f
  530.                   │
  531.                   └──────────── Foreground color
  532.  
  533.  
  534.  
  535.                                      Page 9
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544. ╓────────────────────────────────────────────────────────────────────────────╖
  545. ║  2.4    HELP SCREEN (continued) ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  546. ╙────────────────────────────────────────────────────────────────────────────╜
  547.  
  548.  Where the left digit of the hexidecimal number represents the background
  549.  color, and the right digit represents the foreground color.  Possible
  550.  colors, along with their corresponding hexidecimal values, are listed
  551.  in the charts, below.
  552.  
  553.   ╒═══════════════════════╕  ╒═══════════════╤══════════╕
  554.   │   Foreground colors   │  │   Background  │ Flashing │
  555.   ├─────┬─────────────────┤  ├─────┬─────────┼──────────┤
  556.   │  0  │ Black           │  │  0  │ Black   │   Off    │
  557.   │  1  │ Blue            │  │  1  │ Blue    │   Off    │
  558.   │  2  │ Green           │  │  2  │ Green   │   Off    │
  559.   │  3  │ Cyan            │  │  3  │ Cyan    │   Off    │
  560.   │  4  │ Red             │  │  4  │ Red     │   Off    │
  561.   │  5  │ Magenta         │  │  5  │ Magenta │   Off    │
  562.   │  6  │ Brown           │  │  6  │ Brown   │   Off    │
  563.   │  7  │ White (grey)    │  │  7  │ White   │   Off    │
  564.   │  8  │ Bright Black    │  ╘═════╧═════════╧══════════╛
  565.   │  9  │ Bright Blue     │
  566.   │  a  │ Bright Green    │
  567.   │  b  │ Bright Cyan     │
  568.   │  c  │ Bright Red      │
  569.   │  d  │ Bright Magenta  │
  570.   │  e  │ Yellow          │
  571.   │  f  │ White (bright)  │
  572.   ╘═════╧═════════════════╛
  573.  
  574.  Example color codes:
  575.  
  576.  Yellow on a black background would be:
  577.  ~6 (since 0x0e = 14,  and 14 + 40 is character '6' in the ASCII table)
  578.  
  579.  Black on a white (grey) background would be:
  580.  ~ÿ (since 0x70 = 112, and 112 + 40 is character 'ÿ' in the ASCII table)
  581.  
  582.  If you are unsure of what character represents a decimal number in the
  583.  ASCII table, just press and hold ALT, then enter the number in the numeric
  584.  keypad, then release ALT.  For example:  ÿ is obtained from ALT-152
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                                      Page 10
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602. ╓────────────────────────────────────────────────────────────────────────────╖
  603. ║  2.5    VIEWING ANSI SCREENS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  604. ╙────────────────────────────────────────────────────────────────────────────╜
  605.  
  606.  Select an ANSI screen by entering the number of the screen you want
  607.  displayed.  When the screen is done drawing, press Enter or Space to
  608.  continue.  When you return to the list of screens, you will notice that the
  609.  selection numbers for screens you have viewed will have almost disappeared
  610.  to remind you of which screens you have already viewed (this is what is
  611.  referred to as the "already-seen filter").
  612.  
  613.  A 'slide-show' can be made by entering multiple screen numbers.  Screens will
  614.  be displayed in the same order as they are entered.  Separate the screen
  615.  numbers by a space, comma, or semi-colon.  You can select a range of screens
  616.  to view by using the minus '-' character.  Here's an example slide-show
  617.  selection:  1 5 10 20-30 40
  618.  
  619.  You can escape out of a slide-show by pressing the ESC key.  When the
  620.  current screen has finished you will be brought back to the screen selection
  621.  menu without finishing the slide-show.
  622.  
  623.  While you are using DR ANSI, you can stop/skip or pause any selection or
  624.  ANSI screen by pressing 'S'top/skip or 'P'ause.  If you are using DR ANSI
  625.  remotely, keep in mind that the BBS may be ahead of you and you will still
  626.  see what has already been displayed on the BBS's screen.  In other words,
  627.  the slower your BBS connection, the more delayed the response will be to
  628.  the 'S' and 'P' keys.
  629.  
  630.  If you are viewing ANSI music remotely, chances are that there is not any
  631.  way to stop or skip the remainder of the music on that screen from playing
  632.  because the buffer in the terminal package (e.g. Qmodem) has to play out.
  633.  The only way I know of for getting out of a long ANSI music screen is for
  634.  people who are multi-tasking (e.g. DESQview).  They can usually close their
  635.  current window, open up a new one and load up their terminal package again
  636.  using the same baud rate connection and they should still be on the BBS and
  637.  in DR ANSI, but out of the long ANSI music screen.
  638.  
  639.  
  640. ╓────────────────────────────────────────────────────────────────────────────╖
  641. ║  2.6    BAUD RATE/ANSI SIZE FILTER ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  642. ╙────────────────────────────────────────────────────────────────────────────╜
  643.  
  644.  The purpose of the Baud Rate/ANSI Size Filter is to prevent low speed
  645.  callers from selecting very large ANSI screens in DR ANSI.  ANSIs larger
  646.  than permitted won't appear in the ANSI selection screen and are impossible
  647.  to select.  Use of this filter is optional.  Please see the "Configuration
  648.  File" section for more information on using this feature.
  649.  
  650.  Personally, my rule of thumb is to set the maximum screen size to 10 times
  651.  the baud rate.  I also don't set a maximum screen size for my highest baud
  652.  rate.
  653.  
  654.  
  655.                                      Page 11
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666. ╓────────────────────────────────────────────────────────────────────────────╖
  667. ║  2.7    DOWNLOAD OPTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  668. ╙────────────────────────────────────────────────────────────────────────────╜
  669.  
  670.  You can set up DR ANSI so users on your system can download your ANSI
  671.  screens.  DR ANSI has built-in support for an external DSZ or GSZ, and their
  672.  Xmodem, Ymodem, and Zmodem protocols.  You can specify the file pathname of
  673.  DSZ or GSZ, or have DR ANSI search your computer's PATH environment variable
  674.  for DSZ or GSZ.
  675.  
  676.  When an ANSI screen is downloaded successfully, DR ANSI will show that ANSI
  677.  as having been downloaded by changing the color of the '-' character in the
  678.  ANSI screen selection menu from bright red to dark grey (this is what is
  679.  referred to as the "already-downloaded filter").  This should become
  680.  apparent to the downloader in a very short time, and they will be aware of
  681.  it from then on.  This is to show the user (and sysop) what the user has
  682.  already downloaded during that session with DR ANSI.
  683.  
  684.  Note:    DR ANSI will only show download capability at baud rates greater
  685.           than 0.
  686.  
  687.  GSZ tip: Set a GSZWINDOW environment variable so GSZ doesn't take up your
  688.           whole screen when a user is downloading.  If you set your
  689.           enviroment variable to GSZWINDOW=23 you will still be able
  690.           to see DR ANSI's status bar on the bottom of your screen when
  691.           a person is downloading an ANSI.  The status bar will be updated
  692.           again after the download has finished.
  693.  
  694.  Please see the "Configuration File" section for more information on using
  695.  this feature.
  696.  
  697.  
  698. ╓────────────────────────────────────────────────────────────────────────────╖
  699. ║  2.8    ERRORLEVELS  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  700. ╙────────────────────────────────────────────────────────────────────────────╜
  701.  
  702.  DR ANSI's errorlevels are as follows:
  703.  
  704.   0 - A critical error has occurred
  705.   1 - Carrier lost, user off-line
  706.   2 - Sysop terminated call, user off-line
  707.   3 - User time used up, user STILL ON-LINE
  708.   4 - Keyboard inactivity timeout, user off-line
  709.  10 - User requested exit
  710.  
  711.  
  712.  
  713.  
  714.  
  715.                                      Page 12
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726. ╓────────────────────────────────────────────────────────────────────────────╖
  727. ║  3.1    REGISTRATION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  728. ╙────────────────────────────────────────────────────────────────────────────╜
  729.  
  730.  Please support shareware!
  731.  
  732.  You are granted permission to evaluate DR ANSI for a period of 30 days.
  733.  After this evaluation period a $10.00 (US funds) registration fee is
  734.  required.  If you do not plan to register, then remove DR ANSI and it's
  735.  associated files from use.
  736.  
  737.  Upon receipt of your registration fee, a registration number will be sent to
  738.  you.  Put this registration number in DRANSI.CFG (as shown in the
  739.  "Configuration File" section) to register your copy of DR ANSI.
  740.  
  741.  DR ANSI, as an unregistered copy, is not crippled in any way.  Registered
  742.  owners will receive their registration number that will do the following:
  743.  
  744.    ■ Replace "UNREGISTERED" in the title screen to your name.
  745.  
  746.  
  747.  Your registration is valid for all future versions of DR ANSI.
  748.  
  749.  Please use the file DRANSI.REG to send in your registration information.
  750.  Send your DRANSI.REG information, plus a $10 check or money order (US funds)
  751.  to:
  752.                               Dan Roseen
  753.                               P.O. Box 5695
  754.                               Kent, WA  98064-5695
  755.  
  756.  Please make the check or money order payable to Dan Roseen.
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.                                      Page 13
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784. ╓────────────────────────────────────────────────────────────────────────────╖
  785. ║  3.2    SUPPORT AND DISTRIBUTION ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  786. ╙────────────────────────────────────────────────────────────────────────────╜
  787.  
  788.  Updates and/or new releases of DR ANSI can be downloaded or file-requested
  789.  from my BBS, The Night Owl (shown below).  If you are logging in, you will
  790.  have to fill out a newuser questionnaire.  Once you have done this you will
  791.  have enough access to download DR ANSI without complete user verification.
  792.  You may leave your comments, questions, and suggestions to Dan Roseen
  793.  (or Sysop) if I'm not available for chat.
  794.  
  795.  If you are experiencing problems, call The Night Owl BBS or write me and
  796.  include the following information:
  797.  
  798.   ■ Explanation of the problem.      ■ DRANSI.CFG file.
  799.   ■ BBS type and version number.     ■ AUTOEXEC.BAT and CONFIG.SYS files.
  800.  
  801.  
  802.  You may contact the following systems:
  803.  
  804.  Support and Distribution
  805.  ────────────────────────
  806.  Sysop:      Dan Roseen
  807.  BBS:        The Night Owl (a RemoteAccess BBS)
  808.  Fidonet:    1:343/102
  809.  
  810.  Login:      (206)631-4949       24 Hrs.      Kent, WA - USA
  811.  Max baud:   2400 (expected to be HST/14.4K on June 1, 1993)
  812.  
  813.  Mail/FREQ:  1:343/102                        (this node is not for login)
  814.              2400 to HST/14.4K
  815.  
  816.  Comment:    For downloading latest version:  Download DRANSI*.ZIP
  817.                         For file-requesting:  Request the magic name "DRANSI"
  818.                                               or request DRANSI*.ZIP
  819.  
  820.  Distribution (also Beta-Site)
  821.  ─────────────────────────────
  822.  Sysop:      Andy Nachbaur
  823.  BBS:        Wild Bee's BBS (a Wildcat! BBS)
  824.  
  825.  Login:      (209)826-8107       24 Hrs.      Los Banos, CA - USA
  826.  Max baud:   14.4K
  827.  
  828.  
  829.  Both of the support systems listed above will have a DR ANSI support file
  830.  area containing the latest DR ANSI, fossil driver set up example(s), and
  831.  even some whole sets of ANSI screens that you can use to quickly set up
  832.  different ANSI categories on your own BBS.
  833.  
  834.  
  835.                                      Page 14
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843. ╓────────────────────────────────────────────────────────────────────────────╖
  844. ║  3.3    THANK YOU TO: ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  845. ╙────────────────────────────────────────────────────────────────────────────╜
  846.  
  847.  Denise Roseen, my wife, for her encouragement and for helping me set aside
  848.  time to work on these projects.
  849.  
  850.  David and DeAnne Roseen, my children, for going to bed by 10 PM so I could
  851.  do some late-night programming.
  852.  
  853.  Andy Nachbaur, sysop of Wild Bee's BBS, for his willingness to beta test
  854.  DR ANSI v1.2 and his comments and suggestions.
  855.  
  856.  Albin Gersich for finding a bug when the conditions were high transfer rates
  857.  and slow CPUs.  He also did the testing on v1.2's fix for this bug.
  858.  
  859.  Jerry Harris, sysop of After 10:00 BBS, for testing DR ANSI v1.1, and all
  860.  the help he has given to other Wildcat! sysops who weren't familiar with
  861.  setting up a fossil driver (needed to run DR ANSI).
  862.  
  863.  
  864. ╓────────────────────────────────────────────────────────────────────────────╖
  865. ║  3.4    ACKNOWLEDGEMENTS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  866. ╙────────────────────────────────────────────────────────────────────────────╜
  867.  
  868.  Borland C++  . . . . . . . Borland International Inc.
  869.  DESQview . . . . . . . . . Quarterdeck Office Systems
  870.  DSZ  . . . . . . . . . . . Omen Technology Inc.
  871.  GSZ  . . . . . . . . . . . Omen Technology Inc.
  872.  OpenDoors  . . . . . . . . Brian Pirie
  873.  Qmodem . . . . . . . . . . Mustang Software Inc.
  874.  RemoteAccess . . . . . . . Continental Software
  875.  QEMM . . . . . . . . . . . Quarterdeck Office Systems
  876.  Telix  . . . . . . . . . . Exis Inc.
  877.  Wildcat! . . . . . . . . . Mustang Software Inc.
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.                                      Page 15
  885.